home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Reference Guide / C-C++ Interactive Reference Guide.iso / c_ref / csource3 / 144_01 / num.hlp < prev    next >
Text File  |  1985-08-21  |  2KB  |  45 lines
  1. **********************************************************************
  2. *                               NUM                                  *
  3. **********************************************************************
  4. *                  COPYRIGHT 1983 EUGENE H. MALLORY                  *
  5. **********************************************************************
  6. PROGRAM:
  7.     NUM - Concatenate named files together to produce a line numbered 
  8.     output.
  9. USAGE:
  10.     NUM [<fid] afn ... [>fid]
  11. FUNCTION:
  12.     This can act either as a filter or a source.  If the command line
  13.     contains filenames, these files are read, concatenated, and 
  14.     prefixed with a line number.  Afn's may be used for these 
  15.     file names.
  16.     
  17.     If there is directed input, either from a pipe or from a file, 
  18.     this input is concatenated at the end of any of the files 
  19.     obtained from the command line specifications.  Under no 
  20.     circumstances will this program accept input from the normal 
  21.     keyboard input path.  This allows it to be used as a simple 
  22.     source when no directed input is used.
  23.     
  24. EXAMPLE:
  25.     NUM *.HLP
  26.     NUM F1 F2 F3 >FALL
  27.     NUM <FILELIST >ALLLINES    
  28.  
  29.  
  30.         Command Line                       
  31.  
  32. ___________________________________  
  33.                                   |  
  34.                                   |  
  35.                                   |  AMBIGUOUS FILE NAME LIST
  36.                                   |  
  37.                                   |                  
  38.                     ______________V______________    
  39.  Standard Input     |                           |    Standard Output
  40.      TEXT           |                           |   TEXT WITH NUMBERS
  41. ------------------->|            NUM            |----------------------->
  42.                     |                           |
  43.                     |                           |
  44.                     |___________________________|
  45.